home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 51 / Amiga Format CD51 (2000-03-10)(Future Publishing)(GB)[!][issue 2000-04].iso / -in_the_mag- / freedos / freedos_docs / mini / mini-distrib.txt < prev    next >
Text File  |  2000-02-08  |  7KB  |  151 lines
  1.       HOW TO CREATE A FREEDOS DISTRIBUTION (MINI-HOWTO)
  2.  
  3.              by Jim Hall (jhall1@isd.net)
  4.  
  5. --------------------------------------------------------------------
  6.  
  7. This is how I (currently) build a FreeDOS distribution.  I am writing
  8. this down now so that others can learn how it is done in case someone
  9. else wants to create their own FreeDOS distribution.  I do not have a
  10. problem with someone creating a "better" or "competing" FreeDOS
  11. distribution.  That's what free software is all about.
  12.  
  13. --------------------------------------------------------------------
  14.  
  15. TO CREATE THE BETA 2 DISTRIBUTION:
  16.  
  17. This is a little different from how I created the Beta 1 distribution.
  18. With the Beta 1, I didn't use rph files, so the package description
  19. went into disk description files, and I didn't have other information
  20. like maintainer and official program url.
  21.  
  22. (1) Print out a list of all the FreeDOS programs that are part of the
  23. FreeDOS distribution.  I have made this available at
  24. www.isd.net/jhall1/freedos/fdmain.html, fdext.html, and fdlang.html.
  25. You will use this list to keep track of what you download and have
  26. added to the distribution as packages.
  27.  
  28. (2) Go through the list and download every single program (both exe
  29. and source).  As you download a program, check it off on the list.  I
  30. usually make two columns of check marks: the "download" column would
  31. be column 1.  Since the Beta 2 distribution is the first to use rph
  32. files, I needed to download everything because I was not always sure
  33. if a program has been updated since the Beta 1 distribution.
  34.  
  35. (3) After you have downloaded the programs, turn them into zip files.
  36. I do this under UNIX, because I have all the tools I need and because
  37. I can take advantage of a better file caching system.  Some people
  38. (notably the Command.com group) will distribute their programs and
  39. source as install program packages.  This is great, but most people
  40. will distribute their programs as a zip file containing both exe and
  41. source.  So what I do there is to create a SOURCE\{program} directory,
  42. and unzip it there.  Anything that is an exe I move into a BIN\
  43. directory.  If it's a Help page, I copy it to a HELP\ directory.  If
  44. it's useful documentation, I may copy it to a DOC\{program} directory.
  45. Then, I make a package zip file of the BIN, HELP, and DOC directories,
  46. and a package zip file of the SOURCE directories.
  47.  
  48. (4) Make sure all the package zip files have an 8.3 name, and that the
  49. exe packages end with "x.zip" and the source packages end with
  50. "s.zip".  It is usually a good idea to include the version number in
  51. the name, too, although this is sometimes tricky using 8.3 names.  For
  52. example, for version 1.1 of the FOO program, you might have an exe
  53. package of "FOO11X.ZIP" and a source package of "FOO11S.ZIP".
  54. However, for version 1.6G of Freemacs, you may need to shorten this to
  55. "EMAC16GX.ZIP" and "EMAC16GS.ZIP".
  56.  
  57. (5) Make sure all the package zip files in all the disk series have
  58. unique 8.3 names.  This is so someone can put all the disks series
  59. into a single hard drive directory and install from there.
  60.  
  61. (6) Write your rph files based on the package information.  For this,
  62. I usually do a "view source" on the maintainers lists so I can
  63. cut-and-paste the source url.  You should probably include the author
  64. email, too, instead of just the name.
  65.  
  66. (7) Divide up your packages and rph files for each disk series into
  67. 1.2MB disks.  This leaves a little extra room for the Dat file.  The
  68. way I divide my disks is to create a directory for each series (BASE,
  69. EDIT, ..), then create a disk-number directory under each of those
  70. (BASE\1, BASE\2, ...) and to put all the zip files for a particular
  71. disk into the correct directory path.
  72.  
  73. (8) Create Dat files for each disk in the disk series for the
  74. distribution.  Since you've put all the zip files for the, say, "Base
  75. 1" disk into a BASE\1 directory, you just need to change to the BASE\1
  76. directory, and do this: DIR *.ZIP > BASE.1
  77.  
  78. (9) Edit the Dat files, and replace ".ZIP" with ": Y".  You might want
  79. to change the "Y" to "?" for any optional packages.  I have chosen to
  80. make the FreeDOS kernel optional, for example, so that people are sure
  81. to read the package description before they install it.  I think this
  82. reduces questions about bugs and such.
  83.  
  84. (10) On the last disk in each series, create an End file.  For the
  85. "Base" disk series, the last disk should have a BASE.END file.
  86.  
  87. --------------------------------------------------------------------
  88.  
  89. FOR THE BETA 3 (OR LATER) DISTRIBUTIONS:
  90.  
  91. This should be much easier than building the Beta 1 or Beta 2
  92. releases.  It will at least require less download time.
  93.  
  94. (1) Again, you'll need a printed copy of the maintainers lists, which
  95. shows the programs that are distributed with FreeDOS.
  96.  
  97. (2) It might also help to have a list of program name and version
  98. number that was included in the last distribution.  You can be clever
  99. and use AWK or some other report tool to print a two-column list of
  100. name and version, using the rph files from the last distribution as
  101. the source.  I won't show you the AWK script, because I haven't
  102. written it yet, but I think you'll agree it's pretty easy to write.
  103.  
  104. (3) Cross off from the maintainers list all the packages that have
  105. _not_ changed since the last release.
  106.  
  107. (4) Copy all the packages that you just crossed off to the new
  108. distribution.
  109.  
  110. (5) Download only the programs that have changed, or any that are new
  111. since the last distribution.  You can use your old rph files as a
  112. reference if you don't know where you got them - remember that hte rph
  113. file includes the url to get the program.
  114.  
  115. (6) Create exe and source packages from the downloaded zip files for
  116. each program.
  117.  
  118. (7) Update the rph files for each updated or new package.
  119.  
  120. (8) Divide the packages into disk series.
  121.  
  122. (9) Divide each series into disks.
  123.  
  124. (10) Create the Dat and End files for each disk/series.
  125.  
  126. --------------------------------------------------------------------
  127.  
  128.   Copyright (C) 1998 Jim Hall, jhall1@isd.net
  129.  
  130.   Unless otherwise stated, FD-DOC HOWTO documents are copyrighted by
  131.   their respective authors. FD-DOC HOWTO documents may be reproduced and
  132.   distributed in whole or in part, in any medium physical or electronic,
  133.   as long as this copyright notice is retained on all copies. Commercial
  134.   redistribution is allowed and encouraged; however, the author would
  135.   like to be notified of any such distributions.
  136.  
  137.   All translations, derivative works, or aggregate works incorporating
  138.   any FD-DOC HOWTO documents must be covered under this copyright notice.
  139.   That is, you may not produce a derivative work from a HOWTO and impose
  140.   additional restrictions on its distribution. Exceptions to these rules
  141.   may be granted under certain conditions; please contact the FD-DOC
  142.   HOWTO coordinator at the address given below.
  143.  
  144.   In short, we wish to promote dissemination of this information through
  145.   as many channels as possible. However, we do wish to retain copyright
  146.   on the HOWTO documents, and would like to be notified of any plans to
  147.   redistribute the HOWTOs.
  148.  
  149.   If you have any questions, please contact the FD-DOC coordinator
  150.   at jhall1@isd.net.
  151.